---
title: AI SDK で任意モデルを指定
description: Connect your Agents SDK agents to any model through the Vercel's AI SDK
---

import { Aside, Steps, Code } from '@astrojs/starlight/components';
import aiSdkSetupExample from '../../../../../../examples/docs/extensions/ai-sdk-setup.ts?raw';

<Aside type="caution">
  このアダプターはまだベータ版です。特に小規模なモデルプロバイダーでは問題が発生する可能性があります。問題があれば
  [GitHub issues](https://github.com/openai/openai-agents-js/issues)
  に報告してください。すぐに対応します。
</Aside>

Agents SDK は標準で Responses API または Chat Completions API を通じて OpenAI のモデルと連携します。ただし、別のモデルを使いたい場合は、このアダプターを通じて Agents SDK に取り込める、幅広い対応モデルを [Vercel の AI SDK](https://sdk.vercel.ai/) が提供しています。

## セットアップ

<Steps>

1. extensions パッケージをインストールして AI SDK アダプターを導入します:

   ```bash
   npm install @openai/agents-extensions
   ```

2. [Vercel の AI SDK](https://ai-sdk.dev/docs/foundations/providers-and-models) から利用したいモデル用パッケージを選び、インストールします:

   ```bash
   npm install @ai-sdk/openai
   ```

3. アダプターとモデルをインポートして、エージェントに接続します:

   ```typescript
   import { openai } from '@ai-sdk/openai';
   import { aisdk } from '@openai/agents-extensions';
   ```

4. エージェントで使用するモデルのインスタンスを初期化します:

   ```typescript
   const model = aisdk(openai('gpt-5-mini'));
   ```

</Steps>

<Aside type="caution">
  現在、ai-sdk の model provider v2 モジュール（Vercel AI SDK v5
  と互換）をサポートしています。特別な理由で v1 の model providers
  を使い続ける必要がある場合は、[examples/ai-sdk-v1](https://github.com/openai/openai-agents-js/tree/main/examples/ai-sdk-v1)
  からモジュールをコピーして、プロジェクトに含めてください。
</Aside>

## 例

<Code
  lang="typescript"
  code={aiSdkSetupExample}
  title="AI SDK のセットアップ"
/>

## プロバイダーのメタデータの受け渡し

メッセージにプロバイダー固有のオプションを送る必要がある場合は、`providerMetadata` を通して渡します。値は基盤となる AI SDK モデルにそのまま転送されます。例えば、Agents SDK で次の `providerData`

```ts
providerData: {
  anthropic: {
    cacheControl: {
      type: 'ephemeral';
    }
  }
}
```

は、AI SDK 連携を使用すると次のようになります

```ts
providerMetadata: {
  anthropic: {
    cacheControl: {
      type: 'ephemeral';
    }
  }
}
```
